home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-1.iso / Files / Tele / M / MUBBS / CD ROM V1.0.sit / CD ROM Module ƒ / CD ROM Installation next >
Encoding:
Text File  |  1992-11-15  |  9.0 KB  |  261 lines  |  [TEXT/EDIT]
  1. How to Install the CD ROM Module:  (V1.0  11/92)
  2.  
  3.  
  4. NOTE: This module is "ShareWare", it's NOT FREE TO USE!
  5.  
  6. Please send $20 to me to get a better module, see below.
  7.  
  8. This is the exact module I pulled off my operating BBS, it
  9. has been working now for at least 4 months (as of 11/15/92).
  10.  
  11. A few people have been bugging me to release it. As I
  12. promised, here it is.
  13.  
  14. As with all other "MUBBS Stuff" I give you, please spend
  15. 5 or so hours of *YOUR* time trying to make it work. Read
  16. the MUBBS text that came with MUBBS (by running "MUBBS Tools"
  17. and looking under the "Apple" menu for "help"). If you still
  18. are having problems, post your problem on one of the Support
  19. BBS's and someone should be able to help you.
  20.  
  21. Please don't contact me directly unless you get no answer
  22. from your Support Board. I am busy and there are some really
  23. good people out there that can help you. Your $20 does not
  24. buy you any support time, it buys you UPGRADED SOFTWARE, and
  25. helps keep the Support BBS running!
  26.  
  27. This module is still in "work", there are a few things I
  28. would like to add / improve (see below about this).
  29.  
  30.  
  31. THE MODULE:
  32.  
  33. It just simply allows a user to get a file off of the BBS
  34. from the CD ROM. THEY NEED TO KNOW THE NAME OF THE FILE!
  35.  
  36. You can also use it to access another hard drive that you
  37. have that's full of files. It just want's a Mac Mounted
  38. disk out there, it doesn't care if it's a CD or removeable
  39. Hard Drive, Network Drive or whatever.
  40.  
  41. You need to create CATALOG files from the CD ROM's catalogs
  42. and upload them to a seperate FILE SECTION so that your users
  43. can download them. The user then scans the catalog file ON
  44. THEIR OWN COMPUTER (not tying your system up) and locates
  45. the file(s) they want then calls your BBS and downloads them.
  46.  
  47. This module searches the WHOLE CD ROM for the filename that
  48. they input (or a partial name), THIS TAKES A WHILE AND WILL
  49. SLOW DOWN A SECOND LINE A BIT if you have one. The slow down
  50. is because the SCSI bus is tied up while the CD ROM is searching.
  51.  
  52. Users have asked me if I will have a way to search the CD ROM
  53. for a file by "keywords" while online (a catalog type search)
  54. and I always say NO. The reason is that I don't want people
  55. tying the system up while they look through GIGABYTES of
  56. catalogs to find one file. It's better for them to use THEIR
  57. COMPUTER not mine. They have a computer, why not have them
  58. use it?
  59.  
  60. If you want to see how it actually works, call my system.
  61.  
  62.  
  63. INSTALLATION:
  64.  
  65. Use ResEdit to install the module, it's number is now 199
  66. but you can change that if need be.
  67.  
  68. It's called "cd_rom", that's a UNDERLINE character in the
  69. middle of the name. You need to make a MENU selection that
  70. calls this module's name (like I have my main menu call
  71. the module).
  72.  
  73. The CD ROM needs to be MOUNTED just like a normal disk on
  74. a Mac. You need to know it's volume name, the little name
  75. UNDER THE DISK ICON on the Mac screen.
  76.  
  77. Put the folder called "CD" in the same folder with MUBBS. It
  78. tells the module the name of the module that you want to use,
  79. and contains the CD ROM text files the module uses.
  80.  
  81. I included the files I use for BBS in a Box CD on my system so
  82. you can get a idea of what these files do.
  83.  
  84. The file in the "CD" folder called "thecd" contains the name
  85. of the CD ROM you want to use. It's JUST THE NAME AND A RETURN
  86. CHARACTER in a normal text file.
  87.  
  88. Like:
  89.  
  90.  
  91. AMUG CD
  92.  
  93.  
  94. That's what I use for the BBS in a Box CD ROM. That's the same
  95. name that is under the ICON on the Mac screen. Watch out, some
  96. CD ROM's may have a space after the name, you need to be exact.
  97.  
  98. The file called "cdintro.txt" is the text that is sent when the
  99. module is called by the user. It says whatever you want the
  100. user to know about what CD is online.
  101.  
  102. If the CD ROM happens to be offline (not mounted or something,
  103. or you didn't get the name correct!), the module will just
  104. tell the user the CD ROM is not installed.
  105.  
  106. The file called "cdhelp.txt" is simple a text file that will
  107. be sent if the user presses "help" from the CD ROM menu.
  108.  
  109.  
  110. USE:
  111.  
  112. That's about it, try the module out. Log in and go to the
  113. module, press "Find" and type in something like "Apple". The
  114. module will start searching for any filename match with the
  115. word "Apple" in it and let you know. Dot's will apear as it
  116. searches, telling the user it's busy searching.
  117.  
  118. The user can press "C" at anytime to cancel the search.
  119.  
  120. If you have problems, check that you have the CD's name correct
  121. and that you are calling the module by it's proper name.
  122.  
  123. Then start making those catalogs that people download.
  124.  
  125. I suggest making them TEXT ONLY type files, I hate "Microsoft
  126. Word" files. Reminds me of IBM PC's. Every time they upgrade
  127. "Word" they make a new file format and then other word
  128. processing programs can't read them. Really stupid if you
  129. ask me. Most Word Processing Programs can read MacWrite 5.0
  130. files though.
  131.  
  132. The BBS in a Box CD ROM came with nice ready to go TEXT
  133. files for catalogs. I broke them up into "catagories" and
  134. COMPRESSED them with Stuffit. I also took them all and
  135. made one HUGE file, just incase someone wanted them all.
  136.  
  137. If you break them up, people spend less time downloading
  138. catalog files.
  139.  
  140.  
  141. EJECTION:
  142.  
  143. My CD ROM Ejects sometimes when the computer is RESET or
  144. STARTED UP. Since MUBBS can be set to RELOAD and or
  145. RESTART the system, or if the POWER GOES OUT, the CD ROM
  146. might eject and just hang out there looking silly.
  147.  
  148. What I have done is place a heavy object in front of the CD
  149. ROM/cartridge so that when it ejects, it just sticks itself
  150. back in.
  151.  
  152. I was going to disconnect the ejection thing inside, but
  153. this is working just fine. It ejects once a day or so and
  154. reloads and is just fine so far. If I want to use the CD ROM
  155. myself sometime, it works just the same as usuall.
  156.  
  157. To test it, just throw away the Icon on the Mac and see if
  158. the CD ROM reloads OK.
  159.  
  160. You MAY wear out the load/ unload mechanism, but I think the
  161. CD ROM's head will wear out first, who knows....
  162.  
  163.  
  164. LIMITATIONS: <<<< PAY ATTENTION HERE !
  165.  
  166. You can have 5 CD ROMS and allow your users to access them all!!
  167.  
  168. Because they can get the catalogs and download them, you can
  169. provide catalogs for all your ROMs, then have people request
  170. that you "push the CD in" that they want for a day or two.
  171.  
  172. You will have to change the "thecd" and "cdintro" files each
  173. time you change the CD. I just rename files in my "CD" folder
  174. to do this (to be improved, see below).
  175.  
  176. THIS MODULE DOES NOT "MACBINIFY" NORMAL MAC TYPE FILES FROM CD!
  177.  
  178. What this means is that your users need to use "Hax" or
  179. something to change the type/creator on archived files for the
  180. Mac.
  181.  
  182. YOU MUST TELL THE USERS THIS! See my "cdintro" or "cdhelp" file
  183. I supply here. Technically, it only sends the "DATA FORK" of a
  184. Mac type file. This is OK for '.sit' or '.dd' or most compressed
  185. Mac files.
  186.  
  187. If you have '.GIF' files on CD ROM, they are data fork only
  188. files, as are IBM '.ZIP' and '.TXT' type files.
  189.  
  190. You will have users ask you what's wrong when they try to
  191. download files from a Mac type CD that are NOT COMPRESSED! It
  192. goes on for a little while, then they all get used to it.
  193. (see below for improvements)
  194.  
  195. This module works with MY CD ROM, it has only been tested
  196. on MY COMPUTER and MY CD ROM. I use a "Chinon" CD ROM Drive
  197. and your's may be different. The module really doesn't care
  198. what CD ROM drive it is, it's just looking for the Mounted
  199. Volume you have told it to. However, very slow CD ROM drives
  200. will make searching the CD very slow. If you are running
  201. more than two lines, you may find things get really slow.
  202. Time for a better "RAM Cache" ??
  203.  
  204.  
  205.  
  206. IMPROVEMENTS:
  207.  
  208. I would like to add to the next release these things:
  209.  
  210. Faster search using BTree, locate files by name in a few
  211. seconds.
  212.  
  213. Allow normal "Mac" type programs to be downloaded (see
  214. above about this, it will MacBinify them).
  215.  
  216. Allow the Sysop to just change the CD ROM without needing
  217. to re-write the "thecd" and "cdintro" files. Then you can
  218. have several CD ROMS available and just pop one in. The Module
  219. will search a list of CD ROM names and whatever it finds it
  220. will use for the online ROM and send that "intro" file.
  221.  
  222.  
  223.  
  224.  
  225. THE DEAL:
  226.  
  227. If you become a registered user by sending in $20,I will HOLD
  228. YOUR CHECK (or cash is preferred) until I collect 5 payments
  229. from people, then I will write in the new improvements. If I
  230. don't upgrade the module, you will get your money back.
  231.  
  232. Your $20 pays for the "Next Major Upgrade" of the module, if
  233. there are more improvements later, I may want a small fee again.
  234.  
  235. Cash is preferred and is easier for you, wrap a bill up in
  236. several sheets of paper and mail it.
  237.  
  238. Send to (make checks payable to):
  239.  
  240. CAT Systems
  241. 21115 Devonshire St.
  242. Chatsworth CA 91311
  243.  
  244.  
  245. AOL> N Hawthorn  (Don't try to send money via E-Mail)
  246.  
  247.  
  248. Module and it's source code are COPYRIGHT 1992 N Hawthorn,
  249. All Rights Reserved.
  250.  
  251.  
  252.   DISCLAIMER: This program is a test, it may not be fully debugged, USE AT
  253. YOUR OWN RISK ! BY USING THIS PROGRAM CODE, YOU AGREE TO HOLD IT'S AUTHOR
  254. HARMLESS FROM ANY AND ALL LITIGATION ARISING FROM IT'S USE. This program is
  255. not intended for any particular purpose, and especially not any you expect.
  256. It can crash, wipe out your hard drive, and make your life misiberable. Back
  257. up all data before using. YOU HAVE BEEN WARNED ! This program will self
  258. destruct if not handled in a caring manner.
  259.  
  260.  
  261.